home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / readsource.z / readsource
Encoding:
Text File  |  1998-10-20  |  8.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((3333GGGG))))                                                  rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrreeeeaaaaddddssssoooouuuurrrrcccceeee - sets the source for pixels that various routines read
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((ssssrrrrcccc))))
  13.      lllloooonnnngggg ssssrrrrcccc;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _s_r_c   expects a symbolic constant that identifies the pixel source that
  17.            is to be used:
  18.  
  19.            SSSSRRRRCCCC____AAAAUUUUTTTTOOOO selects the front color buffer when the current
  20.            framebuffer, as specified by ddddrrrraaaawwwwmmmmooooddddeeee, is in single buffer mode. It
  21.            selects the back color buffer when the current framebuffer is in
  22.            double buffer mode.  This is the default.
  23.  
  24.            SSSSRRRRCCCC____FFFFRRRROOOONNNNTTTT selects the front color buffer of the current
  25.            framebuffer, as specified by ddddrrrraaaawwwwmmmmooooddddeeee.  This source is valid for
  26.            both single buffer and double buffer operation.
  27.  
  28.            SSSSRRRRCCCC____BBBBAAAACCCCKKKK selects the back color buffer of the current framebuffer,
  29.            as specified by ddddrrrraaaawwwwmmmmooooddddeeee.  This source is valid only while the
  30.            current framebuffer is in double buffer mode.
  31.  
  32.            SSSSRRRRCCCC____ZZZZBBBBUUUUFFFFFFFFEEEERRRR selects the z-buffer of the current framebuffer.
  33.            Because only the normal framebuffer has a z-buffer, this source is
  34.            currently valid only while draw mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.
  35.  
  36.            SSSSRRRRCCCC____FFFFRRRRAAAAMMMMEEEEGGGGRRRRAAAABBBBBBBBEEEERRRR selects the Live Video Digitizer as the pixel
  37.            source, regardless of the current draw mode.  This source is valid
  38.            only on IRIS-4D GTX and VGX models with the Live Video Digitizer
  39.            option board.  IRIS-4D GTX models support this source only during
  40.            rrrreeeeccccttttccccooooppppyyyy, not rrrreeeeccccttttrrrreeeeaaaadddd or llllrrrreeeeccccttttrrrreeeeaaaadddd.
  41.  
  42.            SSSSRRRRCCCC____OOOOVVVVEEEERRRR selects the overlay planes, and is valid only while draw
  43.            mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  This source is valid only on the Personal
  44.            Iris.
  45.  
  46.            SSSSRRRRCCCC____UUUUNNNNDDDDEEEERRRR selects the underlay planes, and is valid only while draw
  47.            mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  This source is valid only on the Personal
  48.            Iris.
  49.  
  50.            SSSSRRRRCCCC____PPPPUUUUPPPP selects the pop-up planes, and is valid only while draw
  51.            mode is NNNNOOOORRRRMMMMAAAALLLLDDDDRRRRAAAAWWWW.  This source is valid only on the Personal
  52.            Iris.
  53.  
  54.            SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____1111 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____2222 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____3333 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____4444
  55.            SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____5555 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____6666 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____7777 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____8888
  56.            SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____9999 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11110000 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11111111 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11112222
  57.            SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11113333 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11114444 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11115555 SSSSRRRRCCCC____IIIILLLLBBBBUUUUFFFFFFFFEEEERRRR____11116666
  58.            selects the ilbuffers previously allocated with ilbuffer.  This
  59.            source is valid only on the RealityEngine systems running 5.0.1 or
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((3333GGGG))))                                                  rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.            later.
  75.  
  76. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  77.      rrrreeeeaaaaddddssssoooouuuurrrrcccceeee specifies the pixel source buffer that rrrreeeeccccttttccccooooppppyyyy, rrrreeeeaaaaddddppppiiiixxxxeeeellllssss,
  78.      rrrreeeeaaaaddddRRRRGGGGBBBB, rrrreeeeccccttttrrrreeeeaaaadddd, and llllrrrreeeeccccttttrrrreeeeaaaadddd use. A separate read source is
  79.      maintained for each of the GL framebuffers:  normal, pop-up, overlay, and
  80.      underlay.  Calls to rrrreeeeaaaaddddssssoooouuuurrrrcccceeee change the read source of the currently
  81.      active framebuffer, as specified by ddddrrrraaaawwwwmmmmooooddddeeee.  By default the read source
  82.      for each framebuffer is SSSSRRRRCCCC____AAAAUUUUTTTTOOOO.
  83.  
  84.      Because read sources, with the exception of some implemented only on the
  85.      Personal Iris, always specify a source within the current framebuffer, it
  86.      is not possible to copy pixels from one framebuffer to another.  Such a
  87.      copy must be implemented by first reading pixels out of the source
  88.      framebuffer, then changing the draw mode to the destination framebuffer,
  89.      and writing the pixels.
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      lrectread, readpixels, readRGB, rectcopy
  93.  
  94. NNNNOOOOTTTTEEEESSSS
  95.      This subroutine is available only in immediate mode.
  96.  
  97.      On the IRIS-4D B or G models, SSSSRRRRCCCC____ZZZZBBBBUUUUFFFFFFFFEEEERRRR is not available.
  98.  
  99.      Read sources SSSSRRRRCCCC____OOOOVVVVEEEERRRR, SSSSRRRRCCCC____UUUUNNNNDDDDEEEERRRR, and SSSSRRRRCCCC____PPPPUUUUPPPP operate only on the
  100.      Personal Iris.
  101.  
  102. BBBBUUUUGGGGSSSS
  103.      On the IRIS-4D GT and GTX models, and on all Personal IRIS, XS, XS24, XZ,
  104.      Elan and Extreme systems, a single rrrreeeeaaaaddddssssoooouuuurrrrcccceeee variable is shared between
  105.      the four framebuffers.
  106.  
  107.      On the Personal Iris, the source for pixel reads does not change when
  108.      changing framebuffers (via ddddrrrraaaawwwwmmmmooooddddeeee) unless the current selected read
  109.      source is SSSSRRRRCCCC____AAAAUUUUTTTTOOOO (the default).
  110.  
  111.      On some IRIS-4D GT and GTX models, while copying rectangles with blending
  112.      active, rrrreeeeaaaaddddssssoooouuuurrrrcccceeee also specifies the bank from which _d_e_s_t_i_n_a_t_i_o_n color
  113.      and alpha are read (overriding the bbbblllleeeennnnddddffffuuuunnnnccccttttiiiioooonnnn setting).
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.